통합 가이드

@maroo-chain/contracts npm 패키지를 설치하고, Solidity 프리컴파일 인터페이스를 import하며, 사전 생성된 TypeScript ABI를 ethers나 viem에서 소비하는 방법을 설명합니다.

마루 주소 형식 이해하기

마루 계정은 EVM hex (0x…) 와 Bech32 (maroo1…) 두 가지 동등한 문자열 표현을 가집니다. 각각 언제 필요한지, JS/TS에서 어떻게 변환하는지를 함께 안내합니다.

OKRW 프리컴파일 오류 처리하기

OKRW 프리컴파일은 문서화된 모든 mint 실패를 안정적인 4바이트 selector가 붙은 커스텀 오류로 revert합니다. 이 가이드는 UnauthorizedMinter, InvalidAddress, InvalidAmount selector를 Solidity 측과 클라이언트(viem / ethers v6) 측에서 각각 디코드하는 방법을 안내합니다.

EAS 데이터 조회하기

마루 EAS에서 attestation을 읽는 방법을 안내합니다. 정식 surface인 Solidity 컨트랙트 호출, 역방향 조회용 EAS Indexer, JS/TS SDK 세 가지 경로를 다룹니다.

전송 전에 컴플라이언스 검사를 시뮬레이션하는 방법

PCL 래핑 프록시로 향하는 호출을 정적으로 시뮬레이션해 사용자가 서명하기 전에 PCL이 적용 가능한 모든 정책을 평가하도록 하는 방법을 다루는 집중 가이드입니다. dApp 사용자 경험을 개선하고 가스 낭비를 막습니다.

PCL로 규제 준수 ERC20 토큰 만들기 — 처음부터 끝까지

처음부터 끝까지 따라가는 워크스루입니다. EAS로 KYC attestation을 발급하고, 표준 ERC20을 PCL 래핑 프록시 뒤에 배포한 뒤, attestation을 요구하는 ContractPolicyConfig를 부착해 거절 동작을 확인합니다.

Maroo에서 EAS로 신원 검증하기

스키마 등록, attestation 발급, 표준 EVM JSON-RPC를 통한 검증까지 전체 흐름을 단계별로 따라가 봅니다.