EAS 프리컴파일
EAS 프리컴파일은 표준 EAS 모듈 주소인 SchemaRegistry, EAS, Indexer를 반환합니다. 실패는 IPrecompile의 공유 타입 지정 오류 인터페이스를 따르며, 초기화되지 않은 상태에서만 평문 문자열 revert가 발생합니다.
0x1000000000000000000000000000000000000009의 EAS 프리컴파일은 얇은 디스커버리 surface입니다. getParams() view 메서드 하나만 노출하며, 이 체인의 표준 schemaRegistry, eas, indexer 주소를 반환합니다. 실제 attestation API인 발급, 조회, 폐지는 이 프리컴파일이 아니라 EAS 컨트랙트 preinstall에 있습니다. 최신 인터페이스에서 IEas는 IPrecompile을 상속하므로, 인자 형태 실패는 공유 타입 지정 오류 집합의 오류로 반환됩니다.
Solidity 인터페이스
IEas.sol 그대로입니다. IEas는 IPrecompile을 상속하므로 자체 오류 타입을 선언하지 않습니다.import {IPrecompile} from "../common/interfaces/IPrecompile.sol";
address constant EAS_PRECOMPILED_ADDRESS =
0x1000000000000000000000000000000000000009;
struct EasParams {
address schemaRegistry;
address eas;
address indexer;
}
interface IEas is IPrecompile {
function getParams() external view returns (EasParams memory params);
}이 프리컴파일이 존재하는 이유
EAS 컨트랙트, 스키마 레지스트리, 인덱서 모두 genesis에 배포된 preinstall입니다. 주소가 안정적이지만 툴체인이 다루는 모든 체인에서 동일하지는 않으므로, dApp이 이를 하드코딩하면 배포마다 깨집니다.
getParams()는 런타임에 세 주소를 함께 반환하므로, 동일한 코드 경로가 별도 분기 없이 testnet과 mainnet에서 동작합니다.오류 인터페이스 — 공유 IPrecompile과 단일 평문 revert
인자 형태와 디스패치 실패는 공유 오류 집합의 타입 지정 오류로 반환됩니다. 특히 여분의 ABI 인코딩 값이 calldata에 들어오면
InvalidNumberOfArgs(uint256 expected, uint256 got), 인식하지 못하는 selector에는 UnknownMethod(string methodName)이 반환됩니다. 내부 모듈 조회 실패는 QueryFailed(string queryMethod, string reason)로 반환됩니다. 예외가 하나 있습니다. 프리컴파일의 easKeeper 참조가 시작 시점에 연결되지 않으면, 호출은 타입 지정 오류가 아니라 UTF-8 문자열 "eas keeper is not initialized"로 revert됩니다. 타입 디코딩이 실패하면 문자열로 디코드합니다. IPrecompile 전체 목록은 precompile-shared-errors에서 확인할 수 있습니다.import { decodeErrorResult, hexToString } from "viem";
const iPrecompileErrorsAbi = [
{ type: "error", name: "InvalidNumberOfArgs",
inputs: [{ name: "expected", type: "uint256" }, { name: "got", type: "uint256" }] },
{ type: "error", name: "UnknownMethod", inputs: [{ name: "methodName", type: "string" }] },
{ type: "error", name: "QueryFailed",
inputs: [{ name: "queryMethod", type: "string" }, { name: "reason", type: "string" }] },
] as const;
function decodeEasRevert(errData: `0x${string}`) {
try {
return decodeErrorResult({ abi: iPrecompileErrorsAbi, data: errData });
} catch {
// 평문 문자열 revert (예: "eas keeper is not initialized").
return { errorName: hexToString(errData), args: [] };
}
}사용법 — 주소 해석 후 EAS 컨트랙트 직접 호출
getParams()를 시작 시점에 한 번 호출하고 주소를 캐시합니다. 스키마 등록, attestation 발급, attestation 조회, 폐지 등 그 외의 모든 작업은 표준 ABI로 EAS 컨트랙트 또는 SchemaRegistry preinstall을 직접 호출합니다.import { createPublicClient, http } from "viem";
const EAS_PRECOMPILE = "0x1000000000000000000000000000000000000009" as const;
const easPrecompileAbi = [{
type: "function", name: "getParams", stateMutability: "view",
inputs: [],
outputs: [{ type: "tuple", components: [
{ name: "schemaRegistry", type: "address" },
{ name: "eas", type: "address" },
{ name: "indexer", type: "address" },
]}],
}] as const;
const publicClient = createPublicClient({ transport: http("https://rpc-testnet.maroo.io") });
const { schemaRegistry, eas, indexer } = await publicClient.readContract({
address: EAS_PRECOMPILE,
abi: easPrecompileAbi,
functionName: "getParams",
});
// 반환된 `eas`, `indexer`, `schemaRegistry`를 @ethereum-attestation-service/eas-sdk
// 또는 원하는 ABI에 넘겨 실제 attestation 흐름을 진행합니다.
console.log({ schemaRegistry, eas, indexer });